package cn.tedu.minirice.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    /**
     * swagger会帮助我们生成接口文档
     * 1.配置文档信息
     * 2.配置生成规则
     */

    /**
     * 封装接口文档信息
     * @return
     */
    @Bean
    public Docket getDocket(){


        //工厂
        ApiInfoBuilder apiInfoBuilder = new ApiInfoBuilder();
        apiInfoBuilder.title("《小米先生商城》后端接口说明文档")
                .description("此文档详细说明了小米先生商城项目后端接口的规范...")
                .version("v 2.0.1")
                .contact(new Contact("ybyCartman", "www.ybyCartman.com", "632398592@qq.com"));

        ApiInfo apiInfo = apiInfoBuilder.build();
        //如何获取一个接口对象
        //new 接口， 需要在构造器后的{}实现接口中的抽象方法
        //new 子类，实现类
        //工厂模式

        Docket docket = new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo)
                .select()
                .apis(RequestHandlerSelectors.basePackage("cn.tedu.minirice.controller")) //对哪些控制器生成接口文档
                .paths(PathSelectors.any()) //只会对所有 路径下的请求生成文档
                .build();
        //指定文档风格
        //指定生成文档中的封面信息，文档标题，版本，作者
        return docket;
    }
}
